1
Markdown 首要理念与核心架构原则
EvoClass-AI007第 1 课
00:00

OpenClaw 基础

1. Markdown 首要理念

OpenClaw 将可读的文档视为绝对真理来源。与将逻辑深埋于数据库中的系统不同,代理的“灵魂”由文本文件定义,确保了 透明性以及便捷的 版本控制

  • SOUL.md: 定义角色与伦理边界。
  • AGENTS.md: 概述工程工作流程。
  • MEMORY.md: 存储长期事实与偏好。

2. 模型无关且自主

集中式代理运行时允许在不重写逻辑的前提下切换大语言模型(Claude、GPT、本地)。自主代理通过 HEARTBEAT.md 调度器实现 24/7 运行。

3. 可靠性与数据完整性

为防止高并发环境下的 状态损坏,OpenClaw 采用 会话隔离 通过车道队列实现。数据检索由 本地优先 RAG 架构通过语义快照处理。

配置:openclaw.json
{ "global": { "port": 18789, "identity": "./config/SOUL.md", "env_injection": true }, "security": { "firewall": "strict", "rce_protection": true } }
输入命令...
问题 1
为什么 OpenClaw 优先采用 "Markdown 首要" 方法?
为了提升大语言模型的执行速度。
为了确保透明性和人类可读性。
为了完全取代对 JSON 文件的需求。
问题 2
在多个用户同时交互时,什么能防止 "状态损坏"?
本地优先 RAG
语义快照
通过车道队列实现的会话隔离
挑战:调试器
诊断缺失的代理行为。
问题: 一个代理已被部署,但它却以通用人格回应,而非其分配的角色,并且无法回忆起昨天会话中的数据。
分析
哪些文件或组件可能配置错误?
诊断:
1. 角色问题: 检查 SOUL.md 并确保它在 openclaw.json
2. 内存问题: 确保 MEMORY.md 可写,并且 本地优先 RAG 系统正成功创建语义快照。